Skip to content

feat(library): Map View and Drag & Drop Image Geotagging - #2168

Open
Binogulus wants to merge 28 commits into
CyberTimon:mainfrom
Binogulus:feature/mapview
Open

Binogulus wants to merge 28 commits into
CyberTimon:mainfrom
Binogulus:feature/mapview

Conversation

@Binogulus

@Binogulus Binogulus commented Nov 11, 2026 •

Copy link
Copy Markdown

Description

This PR adds an integrated Map View with drag & drop Geotagging module to RapidRAW's Library workspace as a 4th display mode alongside Grid, List, and Culling.

It provides a distraction-free geospatial workflow to explore geotagged photo libraries, cycle through stacked photo clusters directly on the map canvas, assign or adjust GPS coordinates via single/batch drag-and-drop, and jump straight into editing—keeping original RAW/image files 100% untouched via .rrdata and .xmp sidecars.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Performance improvement
  • Code refactoring
  • Documentation update
  • UI/UX improvement
  • Build/CI or Dependency update

Changes Made

1. Native Library & Workspace Integration

  • 4th Library Display Mode: Integrated LibraryDisplayMode.Map into the Library header switcher, with smart auto-centering/zoom when entering Map View with an active photo selected.
  • Full Selection, Sidebar & Editor Sync:
    • Single-click (Ctrl/Cmd+Click, Shift+Click) selects pins and updates the filmstrip and right-hand Info & Metadata panel without intrusive popups.
    • Double-click on any pin or cluster opens the active photo in Adjustments.
    • Right-click on any pin or dock card opens RapidRAW's native context menu (ratings, color labels, flags, albums, export, reset adjustments).

2. Interactive Photographic Clusters (Stacked Photo Cards)

  • Physical Photo Stacks: Grouped markers render as 96×96px front photo cards with tilted -3°/+4° background cards and item count badge.
  • Mouse-Wheel & Card-Click Cycling: Scrolling the mouse wheel over a cluster (or clicking tilted background cards) cycles through all photos in the stack in real time without zooming the map (1/N badge + live Info sidebar sync).
  • Direct Actions on Active Cluster Photo: Selection, double-click to edit, right-click context menu, and drag-and-drop repositioning operate directly on the front cluster photo.
  • Thumbnail & Compact Modes: Individual markers render as 96×96px thumbnail cards with GPS pointer or toggle to Compact Circular Pins.

3. Interactive Geotagging & Unlocated Photos Dock

  • Resizable "Unlocated" Dock: Collapsible right-hand dock listing photos without GPS, styled like Culling cards with real-time resize scaling.
  • Single & Batch Drag-and-Drop: Drag one or multiple selected photos (Ctrl/Cmd+Click, Shift+Click, Ctrl/Cmd+A, or Select All / Deselect All) onto the map at the exact cursor tip; dropping back onto the dock cancels.
  • Direct Marker Repositioning: Drag existing pins/clusters across the map (with floating avatar and count badge) or right-click on the map to place/move selected photos.

4. Non-Destructive Persistence, Undo (Ctrl+Z) & Unified Reset

  • Immutable Source Files: GPS coordinates persist in .rrdata (and .rrcache) and sync to .xmp sidecars (exif:GPSLatitude, exif:GPSLongitude) when XMP sync is enabled.
  • Undo & Reset Integration: In-map Undo stack (Ctrl/Cmd+Z or toolbar button) and integration with native Reset Adjustments (restores original camera EXIF GPS or returns the photo to Unlocated).

5. Switchable Map Styles & Performance

  • 3 Switchable Basemaps: Dark OSM (darkroom filter), Standard OSM, and Satellite (Esri World Imagery) persisted in localStorage.
  • Zero-Cost Thumbnail Reuse: Reuses session-cached thumbnails (mediumThumbnails/thumbnails), lazy-loads 1 thumbnail per visible cluster, updates clusters in O(1) via refreshClusters(), supports smooth fractional zoom (zoomSnap: 0.25), rejects Null Island (< 0.0001°), and adds en.json/it.json translations.

Screenshots/Videos

1. Native Library Switcher
2. Switchable Basemaps & Stacked Clusters
3. Unlocated Dock & Drag-and-Drop Geotagging
4. Native Context Menu

Testing

  • These changes were tested locally by a human and confirmed to work.
  • I haven't added any automated tests to the code because the codebase currently lacks a test suite.

Test Configuration:

  • OS: Linux (Ubuntu 24.04)/Linux Mint 22.3 & Windows 11
  • Hardware: x86_64 Desktop

Checklist

  • My code follows the project's code style
  • I haven't added unnecessary AI-generated code comments
  • My changes generate no new warnings or errors

Additional Notes

  • Aligned with v1.6.9 and latest main (dbb84900).
  • Dependencies added: leaflet, react-leaflet, leaflet.markercluster (@types/leaflet, @types/leaflet.markercluster).

🚀 Try it

  • Build from Source: git clone -b feature/mapview https://github.com/Binogulus/RapidRAW-map-view.git && cd RapidRAW-map-view && npm install && npm start
  • Ready-Made CI Test Builds (Windows, macOS, Linux): Pre-built .AppImage, .deb, .exe, .msi, and .dmg packages are available under Artifacts in the latest main run of Build Multi-OS (Private Test).

AI Disclaimer:

  • This PR is created by an AI agent
  • This PR is mostly AI-generated but edited/merged together by a human
  • This PR was handwritten with AI assistance (spell check, logic suggestions, error resolving)
  • This PR contains only blood, sweat, and coffee (AI-free)

toni and others added 25 commits October 8, 2026 17:11
- Add native MapView in Library panel with Leaflet & MarkerCluster
- Add dynamic photographic cluster cards with item count badges
- Add 96x96px photo pins and 480x260px metadata popups
- Add 3 basemaps (Dark OSM, standard OSM, Esri Satellite) with persistent settings
- Add zero-cost thumbnail loading strategy and Null Island coordinate filtering
- Add multi-OS GitHub Actions workflow for test artifacts
- Update README with RapidMAP feature showcase
…uality and allow cancel by dropping back to dock
# Conflicts:
#	src-tauri/src/file_management.rs
#	src/components/panel/right/ControlsPanel.tsx
#	src/hooks/useEditorActions.ts
#	src/i18n/locales/en.json
#	src/i18n/locales/it.json
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant